VisualApplets
オペレーターリファレンス

Operator Library: Hardware Platform

このオペレーターは、CXPデュアルタップカメラとVisualApplets間の画像データインターフェースを表します。このオペレーターは、シングルチャネル、デュアルチャネル、またはクアッドチャネルのCXPインターフェースに使用できます。インターフェースの種類は、パラメータConnectionCountで選択します。このオペレーターは、カメラが配信するフォーマットに関係なく、各タップポートの生画像データを出力します。その後、この画像データをカメラから送信されたフォーマットに変換する必要があります。画像データを変換するには、生バイト値をピクセル値に集約およびキャストするための適切なオペレーターを使用します。動作中の特定の状況は、以下に説明するようにイベントシステムを介して通知される場合があります。さらに、このオペレーターには、カメラとの接続ステータスを示すさまざまなパラメータがあります。

CXP標準マルチタップ定義

通常、画像ピクセルは左上から右下に向かって順次スキャンされます。しかし、近代的なイメージセンサーのピクセル数が着実に増加しているため、このアプローチでは許容可能なフレームレートが得られません。この問題に対処するため、センサーメーカーは複数のピクセルを同時にスキャンすることで対応しています。CXP標準では、タップの概念を導入することでこの技術に対応しています。タップは、画像ピクセルを順次読み取るスキャンデバイスとみなすことができます。画像のスキャン方法はTap Geometryとして定義され、ホストがデバイスから読み取ります。

CXP標準では、フレームグラバーホストが1X-1Y、1X-1Y2、および1X-2YEの3つのタップフォーマットをサポートすることが推奨されています。タップフォーマット1X-1Yは、左上から右下へピクセル単位で画像をスキャンするデフォルトの特性を表し、一方、他のフォーマットは次の図に示す2つのタップジオメトリを表しています。

各タップからのデータは個別のストリームに形成されますが、ストリームIDとタップの間に固定のマッピングは存在しないことに注意することが重要です。ただし、このマッピングはアクージション中には一定に保たれると仮定して問題ありません。 TapG コード、したがってこのマッピングを見つけるために必要な情報は、オプションの MetaDataTap0/1 ポートで読み取ることができるCXPイメージヘッダーに提供されます。

VisualAppletsでのインスタンス化

このオペレーターは、出力タップに画像データを提供します。この出力は常に存在します。シングルタップの場合は1であり、デュアルタップカメラの場合は2に設定する必要があります。これらの標準出力ポートに加えて、各タップ出力専用にCXPヘッダーメタデータのオプションのMetaData出力を設定できます。つまり、デュアルタップアプリケーションでは、最大2つのMetaDataTapポートを定義できます。オペレーターのインスタンス化時に以下のポップアップダイアログが表示され、次の順列に設定できます：

オプションのMetaDataTapポート

両方のメタデータポートのフォーマットは同一です。 VisualAppletsでは32ビット出力として提供され、次の図に示されています：

各CXPフレームには、対応するエラーフリーの画像ヘッダーが用意されています。不正確な画像ヘッダーの場合、画像ストリームデータはVisualAppletsパイプラインに供給されません。圧縮された画像ヘッダーは6ワードで構成されます。最後のバイトは追加情報に使用され、内部使用のみを目的としています。具体的には、HeaderErrorビットは、画像ヘッダー自体にエラーがあるかどうかを通知します。

デバイスリソースの使用状況

このオペレーターは、パラメータ ConnectionCount の設定に応じて、CameraPort タイプの1つまたは複数のリソースを使用します。system イベントには、EventPort タイプのリソースが使用されます。ConnectionCount が X4（クアッドチャネル）に設定されている場合、次のリソースダイアログが開きます。

エラーハンドリングとイベントシステム

受信した再構築フレームが、CXPイメージヘッダーでカメラから通知されたサイズよりも大きいか小さいかをオペレーターが検出すると、安全回路が有効になります。その後、オペレーターは超過したピクセルとラインを切り捨てるため、後続の処理パイプラインでは常にイメージヘッダーで定義されたフレームサイズが認識されます。受信したフレームの寸法がイメージヘッダーで指定されたものよりも小さい場合、オペレーターは受信したフレームを未定義データで Fill し、イメージヘッダーで定義された指定フレームサイズを実現します。小さいフレームを Fill すると、後続のフレームが失われる可能性があります。この損失はイベントごとにランタイムソフトウェア（Framegrabber SDK）に報告されます（次の段落を参照）。サイズの不一致もイベントを引き起こします。

For a set of very critical errors, the operator will forward asynchronous events to the host runtime software (Framegrabber SDK). The event name in the Framegrabber API is <hierarchical operator name>\CxpStreamStatus, e.g. Device1\Process0\Camera\CxpStreamStatus. The event payload is provided as four 16-bit data words. The event format is defined as follows:

イベントには、破損したエンティティに関するイベントと、失われたエンティティに関するイベントの2種類があります。word 3 の bit 0 は、発生したイベントの種類を示します。イベントバッファがいっぱいになると、イベントが失われることがあります。破損したエンティティを示すイベントが失われた場合、word 3 の bit 1 が設定されます。失われたエンティティを示すイベントが失われた場合、word 3 の bit 2 が設定され、bit 3 から 15 にはフレームの損失を示す失われたイベントの数が提供されます。bit 2 が設定されているにもかかわらず Counter が 0 の場合は、Counter のオーバーフローが発生したことを意味します。

すべてのイベントによってソフトウェア割り込みが発生します。イベントの数を減らすため、同じフレームタグを持つ複数のイベントが統合される場合があります。その場合、一部のエラーフラグが結合されます。イベントが失われた場合、失われたイベントの前のイベントには失われたイベントに関する情報が含まれており、同じフレームタグを持つ後続のイベントと統合することはできません。

CRCエラーによって発生したイベントはフレームタグを報告しますが、これは必ずしもCRCエラーが発生したフレームに正確に対応しているとは限りません。フレームタグは、先行フレームまたは後続フレームのものである可能性があります。これは、カメラが2つ以上のフレーム間のトランジションを含むCXPパケットを送信した場合にのみ発生します。CRCの計算はパケットの終了時に完了しますが、ストリームデータはオンザフライで再構築されます。つまり、先行フレームがすでにオペレーターによって送信された後にのみCRCエラーが検出される状況が発生する可能性があります。カメラパケットに進行中のフレームの末尾と次のフレームの先頭の両方のデータが含まれていない通常の状況では、CRCエラー時のフレームタグは常に正しくなります。完全なフレームストリームデータが8kの最大パケットサイズ未満である限り、その他のすべてのケースでは、1つのパケット内でオーバーラップするフレームは1つだけである可能性があります。その場合、ソフトウェアアプリケーションは、フレームタグ - 1の先行フレームと、フレームタグ + 1の後続フレームについても破損している可能性があると見なす必要があります。